package com.example.demo.dto;

import lombok.Data;

import java.io.Serializable;

/**
 * 通用API响应对象
 * 用于统一后端接口的返回格式，便于前端处理
 * 包含状态码、消息、数据和时间戳四个基本要素
 * 
 * @param <T> 响应数据类型的泛型参数
 */
@Data
public class ApiResponse<T> implements Serializable {
    
    // 序列化ID
    private static final long serialVersionUID = 1L;
    
    /**
     * 状态码：0-成功，非0-失败
     * 0: 表示操作成功
     * 其他值: 表示各种错误情况
     */
    private int code;
    
    /**
     * 响应消息
     * 用于描述操作结果，如"操作成功"、"用户名已存在"等
     */
    private String message;
    
    /**
     * 响应数据
     * 操作成功时返回的数据对象，可以是任何类型
     */
    private T data;
    
    /**
     * 时间戳
     * 记录响应生成的时间，便于调试和日志分析
     */
    private long timestamp;
    
    /**
     * 默认构造函数
     * 仅设置当前时间戳
     */
    public ApiResponse() {
        this.timestamp = System.currentTimeMillis();
    }
    
    /**
     * 完整构造函数
     * 
     * @param code 状态码
     * @param message 响应消息
     * @param data 响应数据
     */
    public ApiResponse(int code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
        this.timestamp = System.currentTimeMillis();
    }
    
    /**
     * 创建成功响应
     * 使用默认成功消息，携带数据
     * 
     * @param data 响应数据
     * @return 成功的API响应对象
     */
    public static <T> ApiResponse<T> success(T data) {
        return new ApiResponse<>(0, "操作成功", data);
    }
    
    /**
     * 创建成功响应（无数据）
     * 使用默认成功消息，不携带数据
     * 
     * @return 成功的API响应对象（无数据）
     */
    public static <T> ApiResponse<T> success() {
        return new ApiResponse<>(0, "操作成功", null);
    }
    
    /**
     * 创建成功响应（自定义消息）
     * 使用自定义成功消息，携带数据
     * 
     * @param message 自定义成功消息
     * @param data 响应数据
     * @return 成功的API响应对象
     */
    public static <T> ApiResponse<T> success(String message, T data) {
        return new ApiResponse<>(0, message, data);
    }
    
    /**
     * 创建失败响应
     * 使用自定义错误码和错误消息
     * 
     * @param code 错误码
     * @param message 错误消息
     * @return 失败的API响应对象
     */
    public static <T> ApiResponse<T> error(int code, String message) {
        return new ApiResponse<>(code, message, null);
    }
    
    /**
     * 创建失败响应（默认错误码）
     * 使用默认错误码(500)和自定义错误消息
     * 
     * @param message 错误消息
     * @return 失败的API响应对象
     */
    public static <T> ApiResponse<T> error(String message) {
        return new ApiResponse<>(500, message, null);
    }

    // Getters and Setters
    /**
     * 获取状态码
     */
    public int getCode() {
        return code;
    }

    /**
     * 设置状态码
     */
    public void setCode(int code) {
        this.code = code;
    }

    /**
     * 获取响应消息
     */
    public String getMessage() {
        return message;
    }

    /**
     * 设置响应消息
     */
    public void setMessage(String message) {
        this.message = message;
    }

    /**
     * 获取响应数据
     */
    public T getData() {
        return data;
    }

    /**
     * 设置响应数据
     */
    public void setData(T data) {
        this.data = data;
    }

    /**
     * 获取时间戳
     */
    public long getTimestamp() {
        return timestamp;
    }

    /**
     * 设置时间戳
     */
    public void setTimestamp(long timestamp) {
        this.timestamp = timestamp;
    }
} 